home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Language/OS - Multiplatform Resource Library
/
LANGUAGE OS.iso
/
cpp_libs
/
rjs.lha
/
RJS
/
String
/
doc
/
string.txt
< prev
next >
Wrap
Text File
|
1991-06-14
|
4KB
|
102 lines
In the following descriptions assume:
- S is a String
- ch is a char
- n,i,p,l are int's
- s is a side type (Left,Right,Both)
- C is either a char, const char *, const String &
- X is either a C or a const Regex &
- Y is either a X or a int (pos)
- Z is either a Y or a int,int (pos and len)
- R is a Regular Expression
return types --
- bool is an int value where zero is false and non-zero is true
- ushort is an unsigned short
- String& is a reference to S
- SubString is a SubString within S, and can be used on
the left hand of assignment ie. S.after("hello")="good bye";
Constructors -
String()
creates a empty String // String s;
String(n)
creates a String with pre-allocated size n // String s(32);
String(ch)
creates a String equal to character ch // String space(' ');
String(const char *)
creates a String equal to const char * // String word("hello");
String(const char *s,int n)
creates a String equal to const char *,with length n // String word(s,4);
String(const String &s)
creates a String equal to another String // String s(word);
returns function description
------- -------- -----------
String& S = X assigns X to S
String& S += Y appends Y to the end of S
String& S -= Y removes Y if at end of S
String& S *= n multiplies S by n
String& S /= X remove all occurances of X from String
String C1 + C2 concats S2 to S1
String C1 - C2 removes string S2 if at the end of S1
String S / X remove all occurances of S2 from S1
char S[i] returns char indexed by 'i'
SubString S(Z) returns the substring Z in S
bool !S true if length=0
bool C1 < C2 standard relational
bool C1 <= C2 " "
bool C1 == C2 " "
bool C1 != C2 " "
bool C1 >= C2 " "
bool C1 > C2 " "
ushort S.length() returns length of string
bool S.empty() true if length=0
const char* (const char *) S converts string to const char *
char* S.cptr() converts string to char *
bool(void *) S true if length!=0 // if (S) ...
ostream& ios << S outputs string
istream& ios >> S inputs string
int getline(ios,S,ch) reads a line into S from steam ios,
using delimiter ch,returns length
int S.index(X) position of X within S
bool S.contains(X) true if S contains X
SubString S.substr(p) substring starting at p to end of S
SubString S.substr(p,l) substring starting at p with length l
SubString S.left(n) left n characters in S
SubString S.right(n) right n characters in S
SubString S.between(n1,n2) characters between n1 and n2
String& S.insert(p,C) inserts C into S at position p
String& S.prepend(C) prepends C to S
String& S.append(C) appends C to S
String& S.remove(Z) removes Z from S
SubString S.before(Y) substring S before Y
SubString S.through(Y) substring through (upto and including) Y
SubString S.at(Z) substring at Z
SubString S.from(Y) substring from Y to end of S
SubString S.after(Y) substring after Y to end of S
String S.except(Z) everything in S except Z
SubString S.skip(X) skips optional X, returns substring after
SubString S.ws() skips white space
String& S.replace(X1,X2) replaces X1 with X2
SubString S.pos(i) assigns i current position within S
SubString S.moveto(X) moves upto X and returns from X to end
SubString S.find(X) finds X in S, return after X to end
SubString S.match(X) matches X with leftmost side of S
int S.split(R,S1[],n) splits S into string array S1[0..n],
on Regex R and returns number split
String& S.trim(s) trims white space on side s
String& S.pad(n,s,ch) pads to length n with char ch on side s
String& S.trunc(n) truncates S to length n
String& S.upper() upper cases string
String& S.lower() lower cases string
String& S.reverse() reverse string
String& S.icase() ignores case during next relational
operation // S.icase() < "HELLO"
String& S.ucase() uses case during next relational op.
void S.dump() dumps out string contents (for debug)
void S.exception() exits program and dumps out string